package com.cheerful.blog.service;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.cheerful.blog.entity.Article;
import com.cheerful.blog.to.ArchiveVo;
import com.cheerful.blog.to.ArticleVo;
import org.springframework.web.multipart.MultipartFile;

import java.io.IOException;
import java.util.List;

/**
 * (Article)表服务接口
 *
 * @author makejava
 * @since 2022-02-07 13:15:02
 */
public interface ArticleService extends IService<Article> {

    /**
     * 获取博文详情，包括评论、标签等等
     *
     * @param id 文章id
     * @return
     */
    ArticleVo getArticleDetail(Long id);

    /**
     * 获取某个分类下的文章
     * @param categoryId
     * @return
     */
    List<Article> getArticleByCategory(Long categoryId);

    /**
     * 统计某分类的文章数量
     * @param categoryId 分类id
     * @return
     */
    Integer countCategory(Long categoryId);

    /**
     * 分页获取获取博文详情，包括评论、标签等等
     * @param page
     * @param articleQueryWrapper
     * @return
     */
    Page<ArticleVo> pageWithDetail(Page<Article> page, QueryWrapper<Article> articleQueryWrapper);

    /**
     * 获取热门的三篇文章
     * @return
     */
    List<Article> getHotArticles();

    /**
     * 更新浏览量
     * @param id
     * @param viewNums
     */
    void updateViewNums(Long id, Integer viewNums);

    /**
     * 按年月分组，获取归档页文章信息
     * @return
     */
    List<ArchiveVo> getArticlesGroupByYearMonth();


    /**
     * 添加博客
     * @param picture 封面图片
     * @param mdFile md文件
     * @param title 标题
     * @param blogDesc 文章介绍
     * @param categoryList 分类
     * @return
     */
    Article addArticle(MultipartFile picture, MultipartFile mdFile, String title, String blogDesc, String categoryList) throws IOException;
}

